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PREFACE 


This  product  specification  covers  the  work  performed  tinder 
Air  Force  Contract  F33615-80-C-5155  (ICAM  Project  6201).  This 
contract  is  sponsored  by  the  Materials  Laboratory,  Air  Force 
Systems  Command,  Wright-Pat terson  Air  Force  Base,  Ohio.  It  was 
administered  under  the  technical  direction  of  Mr.  Gerald  C. 
Shumaker,  ICAM  Program  Manager.  Manufacturing  Technology 
Division,  through  Project  Manager.  Mr.  David  Judson.  The  Prime 
Contractor  was  Production  Resources  Consulting  of  the  General 
Electric  Company,  Schenectady,  New  York,  under  the  direction  of 
Mr.  Alan  Rubenstein.  The  General  Electric  Project  Manager  was 
Mr.  Myron  Hurlbut  of  Industrial  Automation  Systems  Department, 
Albany.  Mew  York. 

Certain  work  aimed  at  improving  Test  Bed  Technology  has 
been  performed  by  other  contracts  with  Project  6201  performing 
integrating  functions.  This  work  consisted  of  enhancements  to 
Test  Bed  software  and  establishment  and  operation  of  Test  Bed 
hardware  and  communications  for  developers  and  other  users. 
Documentation  relating  to  the  Test  Bed  from  all  of  these 
contractors  and  projects  have  been  integrated  under  Project  6201 
for  publication  and  treatment  as  an  integrated  set  of  documents. 
The  particular  contributors  to  each  document  are  noted  on  the 
Report  Documentation  Page  (DD1473).  A  listing  and  description 
of  the  entire  project  documentation  system  and  how  they  are 
related  is  contained  in  document  FTR620100001 ,  Project  Overview. 

The  subcontractors  and  their  contributing  .activities  were 
as  follows: 


TASK  4.2 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

D.  Appleton  Company 
(DACOM) 


General  Dynamics/ 
Ft.  Worth 


Role 

Reviewer 


Responsible  for  IDEF  support, 
state-of-the-art  literature 
search 

Responsible  for  factory  view 
function  and  information 
models 
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Subcontractors 

Illinois  Institute  of 
Technology 

North  American  Rockwell 
Northrop  Corporation 

Pritsker  and  Associates 
SofTech 

TASKS  4.5  -  4.9  (TEST  BED) 

Subcontractors 

Boeing  Military  Aircraft 
Company  (BMAC) 

Computer  Technology 
Associates  (CTA) 

Control  Data  Corporation 
(CDC) 


D.  Appleton  Company 
(DACOM) 

( shared 


Role 

Responsible  for  factory  view 
function  research  (IITRI) 
and  information  models  of 
6mall  and  medium-size  business 

Reviewer 

Responsible  for  factory  view 
function  and  information 
models 

Responsible  for  IDEF2  support 
Responsible  for  IDEFO  support 


Role 

Responsible  for  consultation  on 
applications  of  the  technology 
and  on  IBM  computer  technology. 

Assisted  in  the  areas  of 
communications  systems,  system 
design  and  integration 
methodology,  and  design  of  the 
Network  Transaction  Manager. 

Responsible  for  the  Common  Data 
Model  (CDM)  implementation  and 
part  of  the  CDM  design  (shared 
with  DACOM). 

Responsible  for  the  overall  CDM 
Subsystem  design  integration 
and  test  plan,  as  well  as  part 
of  the  design  of  the  CDM 

with  CDC).  DACOM  also 
developed  the  Integration 
Methodology  and  did  the  schema 
mappings  for  the  Application 
Subsystems . 
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Subcontractors 


Role 


Digital  Equipment 
Corporation  (DEC) 


McDonnell  Douglas 
Automation  Company 
(McAuto) 


Consulting  and  support  of  the 
performance  testing  and  on  DEC 
software  and  computer  systems 
operation . 

Responsible  for  the  support  and 
enhancements  to  the  Network 
Transaction  Manager  Subsystem 
during  1984/1985  period. 


On-Line  Software 
International  (OSI) 


Responsible  for  programming  the 
Communications  Subsystem  on  the 
IBM  and  for  consulting  on  the 
IBM. 


Rath  and  Strong  Systems 
Products  (RSSP)  (In  1985 
became  McCormack  8  Dodge) 


Sof Tech ,  Inc . 


Software  Performance 
Engineering  (SPE) 


Structural  Dynamics 
Research  Corporation 
(SDRC) 


Responsible  for  assistance  in 
the  implementation  and  use  of 
the  MRP  II  package  (PIOS)  that 
they  supplied. 

Responsible  for  the  design  and 
implementation  of  the  Network 
Transaction  Manager  (NTM)  in 
1981/1984  period. 

Responsible  for  directing  the 
work  on  performance  evaluation 
and  analysis. 

Responsible  for  the  User 
Interface  and  Virtual  Terminal 
Interface  Subsystems. 


Prime  contractors  under  other  projects  who  have  contributed 
to  Test  Bed  Technology,  their  contributing  activities  and 
responsible  projects  are  as  follows: 


Contractors 


I CAN  Project  Contributing  Activities 


Boeing  Military 
Aircraft  Company 
(BMAC) 


1701 ,  2201 ,  Enhancements  for  IBM 
2202  node  use.  Technology 

Transfer  to  Integrated 
Sheet  Metal  Center 
( I SMC ) 
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Contractors 

ICAM  Project 

Contributing  Activities 

Control  Data 
Corporation  (CDC) 

1502,  1701 

IISS  enhancements  to 
Common  Data  Model 
Processor  (CDMP) 

D.  Appleton  Company 
(DACOM) 

1502 

IISS  enhancements  to 
Integration  Methodology 

General  Electric 

1502 

Operation  of  the  Test 
Bed  and  communications 
equipment . 

Hughes  Aircraft 

Company  (HAC) 

1701 

Test  Bed  enhancements 

Structural  Dynamics 
Research  Corporation 
(SDRC) 

1502.  1701, 
1703 

IISS  enhancements  to 
User  Interface/ Virtual 
Terminal  Interface 
(UI/VTI) 

Systran 

1502 

Test  Bed  enhancements . 
Operation  of  Test  Bed. 
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SECTION  1 

i 

!  SCOPE 


1 . 1  Iden t i f i cat i on 


This  specification  establishes  the  detailed  design  of  a 
computer  program  identified  as  the  Application  Interface, 
hereinafter  referred  to  as  AI .  The  AI  is  one  configuration  item 
of  the  Integrated  Information  Support  System  (IISS)  User 
Interface  (  UI )  .\ 


1  • 2  Functional  Summary 


^The  AI  is  a  collection  of  procedures  that  may  be  linked 
with  an  application  to  enable  it  to  use  the  Form  Processor  (FP) 
and  run  in  the  distributed  IISS  environment.  The  AI  does  this 
by  sending/ receiving  FP  requests  through  the  NTM  (Network 
Transaction  Manager)  to/ from  the  User  Interface  Monitor  (UIM)  of 


the  Form  Processor. 
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SECTION  2 
DOCUMENTS 


2.1  Reference  Documents 


[1]  Structural  Dynamics  Research  Corporation,  Forms 
Dr i ven  Form  Editor  Product  Specification, 

PS  620144402  ,  1  November  1985. 

[2]  Structural  Dynamics  Research  Corporation,  Forms 
Language  Compi ler  Product  Specif i cat ion, 

PS  620144401  ,  1  November  1985. 

[3]  Structural  Dynamics  Research  Corporation,  Form 
Processor  Product  Specification,  PS  620144200  , 

1  November  1985. 

[4]  Structural  Dynamics  Research  Corporation,  Rapid 
Appl i cat  ion  Generator  Product  Specification, 

PS  620144502  .  1  November  1985. 

[5]  Structural  Dynamics  Research  Corporation,  Report 
Writer  Product  Specification ,  PS  620144501  , 

1  November  1985. 

[6]  Structural  Dynamics  Research  Corporation.  Text 
Editor  Product  Specification ,  PS  620144600  , 

1  November  1985 . 

[7]  Structural  Dynamics  Research  Corporation,  User 
Interface  Services  Product  Specification, 

PS  620144100  ,  1  November  1985. 

[8]  Structural  Dynamics  Research  Corporation,  Virtual 
Terminal  Product  Specification,  PS  620144300  , 

1  November  1985. 

[9]  Structural  Dynamics  Research  Corporation,  Appl i cat  ion 
Interface  Development  Specification,  DS  620144700  , 

1  November  1985. 

[10]  Structural  Dynamics  Research  Corporation,  Application 
Inteface  Unit  Test  Plan ,  UTP620144700  ,  1  November 
1985. 


PS  620144700 
1  November  1985 


2.2  Terms  and  Abbreviations 

American  Standard  Code  for  Information  Interchange: 

(ASCII ) ,  the  character  set  defined  by  ANSI  X3.4  and  used  by  most 
computer  vendors . 

Application  Definition  Language :  an  extension  of  the  Forms 
Definition  Language  that  includes  retrieval  of  database 
information  and  conditional  actions.  It  is  used  to  define 
interactive  application  programs . 

Appl i cat ion  Generator :  (AG),  subset  of  the  IISS  User 
Interface  that  consists  of  software  modules  that  generate  IISS 
application  code  and  associated  form  definitions  based  on  a 
language  input.  The  part  of  the  AG  that  generates  report 
programs  is  called  the  Report  Writer.  The  part  of  the  AG  that 
generates  interactive  applications  is  called  the  Rapid 
Application  Generator. 

Attribute:  field  characteristic  such  as  blinking, 
highlighted,  black,  etc.  and  various  other  combinations. 
Background  attributes  are  defined  for  forms  or  windows  only. 
Foreground  attributes  are  defined  for  items.  Attributes  may  be 
permanent,  i.e.,  they  remain  the  same  unless  changed  by  the 
application  program,  or  they  may  be  temporary,  i.e.,  they  remain 
in  effect  until  the  window  is  redisplayed. 

Buffer  Name:  the  default  file  in  which  the  buffer  will  be 
saved  if  no  file  is  given  on  a  save  command. 

Common  Data  Model :  (CDM),  IISS  subsystem  that  describes 
common  data  application  process  formats,  form  definitions,  etc. 
of  the  IISS  and  includes  conceptual  schema,  external  schemas, 
internal  schemas,  and  schema  transformation  operators. 

Conceptual  Schema :  (CS),  the  standard  definition  used  for 
all  data  in  the  CDM.  It  is  based  on  IDEF1  information 
model  ling. 

Current  Cursor  Position:  the  position  of  the  cursor  before 
an  edit  command  or  function  is  issued  in  the  text  editor. 

Cursor  Position:  the  position  of  the  cursor  after  any 
command  is  is  sued . 

Cut  and  Paste  Buffer :  where  deleted  lines  go  and  the  paste 
and  fill  edit  commands  get  their  data. 
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Device  Drivers :  (DD),  software  modules  written  to  handle 

I/O  for  a  specific  kind  of  terminal.  The  modules  map  terminal 
specific  commands  and  data  to  a  neutral  format.  Device  Drivers 
are  part  of  the  UI  Virtual  Terminal . 

Display  List :  is  similar  to  the  open  list,  except  that  it 
contains  only  those  forms  that  have  been  added  to  the  screen  and 
are  currently  displayed  on  the  screen. 

Display  Start  Line :  the  first  line  in  the  buffer  to  be 
displayed. 

Display  Size :  the  number  of  lines  used  in  the  edit  area. 

Extended  Binary  Coded  Decimal  Interchange  Code :  (EBCDIC), 
the  character  set  used  by  a  few  computer  vendors  (notably  IBM) 
instead  of  ASCII. 

External  Schema:  (ES),  an  application's  view  of  the  CDM's 
conceptual  schema. 

Field  Pointer :  indicates  the  ITEM  which  contains  the 
current  cursor  position. 

Forms  Dr i ven  Form  Editor :  ( FDFE ) ,  subset  of  the  FE  which 
consists  of  a  forms  driven  application  used  to  create  Form 
Definition  files  interactively. 

Form  Editor :  (FE),  subset  of  the  IISS  User  Interface  that 
is  used  to  create  definitions  of  forms.  The  FE  consists  of  the 
Forms  Driven  Form  Editor  and  the  Forms  Language  Compiler. 

Forms  Language  Compiler :  (FLAN),  subset  of  the  FE  that 
consists  of  a  batch  process  that  accepts  a  series  of  forms 
definition  language  statements  and  produces  form  definition 
files  as  output. 

Form  Processor  Text  Editor :  (FPTE),  subset  of  the  Form 
Processor  that  consists  of  software  modules  that  provide  text 
editing  capabilities  to  all  users  of  applications  that  use  the 
Form  Processor. 

Item:  non -decomposable  area  of  a  form  in  which  hard-coded 
descriptive  text  may  be  placed  and  the  only  defined  areas  where 
user  data  may  be  input/output. 
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Logical  Device:  a  conceptual  device  which  to  an  application 
is  indistinguishable  from  a  physical  device  and  is  then  mapped 
to  part  or  all  of  a  physical  device. 

Neutral  Data  Manipulation  Language:  (NDML),  the  command 
language  by  which  the  CDM  is  accessed  for  the  purpose  of 
extracting,  deleting,  adding,  or  modifying  data. 

Open  List :  a  list  of  all  the  forms  that  have  been  and  are 
currently  open  for  an  application  process. 

Operating  System :  (OS),  software  supplied  with  a  computer 
which  allows  it  to  supervise  its  own  operations  and  manage 
access  to  hardware  facilities  such  as  memory  and  peripherals. 

Page :  instance  of  forms  in  windows  that  are  created 
whenever  a  form  is  added  to  a  window. 

Paging  and  Scrolling:  a  method  which  allows  a  form  to 
contain  more  data  than  can  be  displayed  with  provisions  for 
viewing  any  portion  of  the  data  buffer. 

Physical  Device:  a  hardware  terminal. 

Presentation  Schema :  (PS),  may  be  equivalent  to  a  form.  It 
is  the  view  presented  to  the  user  of  the  application. 

Previous  Cursor  Position :  the  position  of  the  cursor  when 
the  previous  edit  command  was  issued. 

Previous  Edit  Command :  the  function  key  pressed  before  the 
current  one. 

Rapid  Appl i cat  ion  Generator :  (RAP),  part  of  the  Application 
Generator  that  generates  source  code  for  interactive  programs 
based  on  a  language  input. 

Report  Definition  Language:  an  extension  of  the  Forms 
Definition  Language  that  includes  retrieval  and  calculation  of 
database  information  and  is  used  to  define  reports. 

Report  Writer :  (RW),  part  of  the  Application  Generator  that 
generates  source  code  for  report  programs  based  on  a  language 
input . 

Select  Line :  one  terminus  of  the  select  range. 
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Select  Mode:  when  on,  certain  commands  will  be  executed 
over  the  lines  in  the  selected  range.  The  commands  are  <DELETE 
LINE >  and  replace. 

Subform:  a  form  that  is  used  within  another  form. 

Text  Editor:  (TE),  subset  of  the  IISS  User  Interface  that 
consists  of  a  file  editor  that  is  based  on  the  text  editing 
functions  built  into  the  Form  Processor. 

Top  of  f i le:  the  first  line  of  the  buffer. 

User  Interface  Development  System:  (UIDS),  collection  of 
IISS  User  Interface  subsystems  that  are  used  by  applications 
programmers  as  they  develop  IISS  applications.  The  UIDS 
includes  the  Form  Editor  and  the  Application  Generator. 

User  Interface  Monitor :  (UIM),  part  of  the  Form  Processor 
that  handles  messaging  between  the  NTM  and  the  UI .  It  also 
provides  authorization  checks  and  initiates  applications. 

User  Interface  Services:  (UIS),  subset  of  the  IISS  User 
Interface  that  consists  of  a  package  of  routines  that  aid  users 
in  controlling  their  environment.  It  includes  message 
management,  change  password,  and  application  definition 
services . 

Virtual  Terminal  Interface:  (VTI),  the  callable  interface 
to  the  VT. 

Virtual  Terminal  Interface  Field  Map:  defines  the  complete 
terminal  screen  by  breaking  it  into  pieces  of  the  various  forms 
and  items  that  are  displayed.  Each  area  of  the  terminal  screen 
must  be  defined  as  belonging  to  a  particular  field  in  the 
display  list. 


Window  Manager:  a  facility  which  allows  the  following  to  be 
manipulated:  size  and  location  of  windows,  the  device  on  which 
an  application  is  running,  the  position  of  a  form  within  a 
window.  It  is  part  of  the  Form  Processor. 
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SECTION  3 
REQUIREMENTS 


3 . 1  Structural  Description 

Applications  use  the  AI  just  as  though  they  were  using  the 
User  Interface  Form  Processor.  The  Application  Interface 
routines  have  the  same  calling  sequence  as  the  FP  routines,  but 
instead  of  processing  the  commands  the  AI  creates  messages  which 
are  sent  to  the  Form  Processor  by  way  of  the  Network  Transaction 
Manager.  The  Form  Processor  then  processes  the  command  which  is 
contained  in  the  message.  This  structure  allows  the  application 
program  to  run  on  a  machine  other  than  the  host  of  the  User 
Interface.  The  detailed  structure  of  the  Application  Interface 
is  illustrated  in  section  3.10.  Figure  3-1  illustrates  the 
relationship  between  the  AI,  NTM,  FP  and  an  application. 


+— ————————— — — ——————+ 

i  application  i 
I  I 

+ - + 

i  i 

I  AI  I 

+ - + - + 


i  messages 


I 

v 

+ - + - + 

I  l 

I  NTM  I 

+ - + - + 


i  messages 
I 

v 


+ - + - + 

i  f 

I  UIM/FP  I 

+ - + 


Figure  3-1  AI  Interfaces 
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3.2  Functional  Flow 

Figure  3-2  is  a  data  flow  diagram  of  the  Application 
Interface. 


Figure  3-2  Application  Interface  Data  Flow 


3 . 3  Interfaces 

3.3.1  Application  Programs 

The  interface  to  the  application  is  identical  to  that  of 
the  Form  Processor  procedures  and  is  documented  in  the  FP  User 
Manual . 

3.3.2  Network  Transaction  Manager 

The  AI  sends  and  receives  messages  to  and  from  the  UIM  via 
the  NTH.  Each  FP  procedure  is  identified  by  a  unique  number  in 
this  message.  The  remainder  of  the  message  consists  of  FP  input 
parameters  for  an  AI  send  and  FP  output  parameters  for  an  AI 
receive.  These  message  formats  are  documented  in  Appendix  A. 
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3.3.3  Form  Processor 


The  UIH  of  the  Form  Processor  receives  messages  from  the 
MTM,  calls  the  appropriate  FP  procedure  and  sends  the  results 
back  to  the  AI  via  the  MTM. 

3.4  Program  Interrupts 

This  section  does  not  apply  to  the  detailed  design  of  the 
Application  Interface. 

3.5  Timing  and  Sequencing  Description 

The  Application  Interface  control  logic  is  simple.  First, 
the  AI  receives  input  parameters  from  an  application  and  sends 
the  parameters  to  the  FP  via  the  MTM.  Then  the  AI  receives 
output  parameters  from  the  FP  via  the  MTM  and  returns  them  to 
the  application.  This  is  illustrated  in  the  flow  diatram  in 
section  3.2. 

3.6  Special  Control  Features 

The  detailed  design  of  the  Application  Interface  does  not 
include  any  special  control  features  as  defined  in  the  ICAM 
Documentation  Standards  manual . 

3 . 7  Storage  Allocation 

This  section  does  not  apply  to  the  AI . 

3.8  Object  Code  Creation 

The  AI  routines  were  compiled  with  an  ANSI  COBOL  compiler 
under  VAX/VMS.  The  source  is  portable  to  other  compilers  on 
machines  such  as  the  IBM. 

3.9  Adaptation  Data 

The  AI  source  is  portable  to  other  ANSI  COBOL  compilers. 

3 . 10  Detailed  Design  Description 
3.10.1  Main  Program  List 

The  following  is  a  list  of  all  'Main  Programs”  which 
are  modules  that  are  not  called  by  any  other  module  being 
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documented  here.  These  modules  are  either  program  entry  points 
or,  if  they  are  hooked  into  another  set  of  programs  via 
subroutine  calls,  they  are  the  points  the  external  programs  can 
call  and  therefore  enter  through.  To  differentiate  between  the 
two  types  of  entry  points,  look  at  the  individual  Module 
Docuaentat ion  (section  3.10.8)  and  look  at  Module  Type  for  each 
of  the  Main  Prograa  aodules  listed.  Mote  whether  the  routine 
is  a  Program,  Subroutine,  or  Function.  If  it  is  a  Program,  it 
is  truly  a  main  program  entry  point.  If  not,  then  it  is  merely 
called  by  other  programs  not  being  documented  here. 


3-4 


Module 

ADDELM 

ADDFRM 

CHGLDV 

CLSFRM 

CLSLDV 

GDATA 

GETATT 

GETBAK 

GETCUR 

GPAGE 

GW  IN  DO 

INITFP 

INITVT 

INQLDV 

OISCR 

OPMFRM 

OPNLDV 

OUTSCR 

PARFQN 

PDATA 
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APPLICATION  INTERFACE  Main  Program  List 
Name  Purpose 

ADO  ELEMENT 
ADD  FORM 

CHANGE  LOGICAL  DEVICE 
CLOSE  FORM 

CLOSE  LOGICAL  DEVICE 

GET  DATA 

GET  ATTRIBUTES 

GET  BACKGROUND 

GET  CURSOR 

GET  PAGE 

GET  WINDOW 

INITialize  Form  Processor 
INITIAL  VTI 

INQUIRE  LOGICAL  DEVICE 
OUTPUT  /  INPUT  SCREEN 
OPEN  FORM 

OPEN  LOGICAL  DEVICE 
OUTPUT  SCREEN 
PARSE  FULLY  QUALIFIED  NAME 
PUT  DATA 


PMSGLC 


PUT  MESSAGE  LINE  CODE 


Module 

PMSGLS 

PUTATT 

PUTBAK 

PUTCUR 

PUTLOC 

RMVPAG 

RPLFRM 

TERMFP 
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APPLICATION  INTERFACE  Main  Program  List 
Name  Purpose 

POT  MESSAGE  LINE  STRING 

PUT  ATTRIBUTES 

PUT  BACKGROUND 

PUT  CURSOR 

PUT  CURSOR  LOCATION 

REMOVE  PAGE 

REPLACE  FORM 

EXIT  FORM  PROCESSOR 


TERMVT 


TERMINATE  VTI 
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3.10.2  Module  List 

The  following  is  a  list  of  all  the  modules  being 
documented  here  along  with  their  purpose.  Each  module  has  a 
unique  name,  no  matter  what  language  it  was  written  in. 


vk'-.yv'-j.** 


aw 
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APPLICATION  INTERFACE  Module  List 


Module  Name 

Purpose 

ADDELM 

ADD  ELEMENT 

ADDFRM 

ADD  FORM 

CHGLDV 

CHANGE  LOGICAL  DEVICE 

CLSFRM 

CLOSE  FORM 

CLSLDV 

CLOSE  LOGICAL  DEVICE 

GDATA 

GET  DATA 

GDATLN 

GET  DATA  LENGTH 

GETATT 

GET  ATTRIBUTES 

GETBAK 

GET  BACKGROUND 

GETCUR 

GET  CURSOR 

GETUIM 

GET  USER  INTERFACE  MONITOR  AP 

GPAGE 

GET  PAGE 

GVINDO 

GET  WINDOW 

INITFP 

INITialize  Form  Processor 

INITVT 

INITIAL  VTI 

INQLDV 

INQUIRE  LOGICAL  DEVICE 

01  SCR 

OUTPUT  /  INPUT  SCREEN 

OPNFRM 

OPEN  FORM 

OPNLDV 

OPEN  LOGICAL  DEVICE 

OUTSCR 

OUTPUT  SCREEN 

PARFQN 


PARSE  FULLY  QUALIFIED  NAME 


Module 

PDATA 

PMSGLC 

PMSGLS 

PUTATT 

PUTBAK 

PUTCUR 

PUTLOC 

RMVPAG 

RPLFRM 

TERMFP 
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APPLICATION  INTERFACE  Module  List 
Name  Purpose 

PUT  DATA 

PUT  MESSAGE  LINE  CODE 

PUT  MESSAGE  LINE  STRING 

PUT  ATTRIBUTES 

PUT  BACKGROUND 

PUT  CURSOR 

PUT  CURSOR  LOCATION 

REMOVE  PAGE 

REPLACE  FORM 

EXIT  FORM  PROCESSOR 


TERMVT 


TERMINATE  VTI 
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3.10.3  External  Routines  List 

The  following  is  a  list  of  all  routines  or  functions  not 
documented  here  that  are  called  by  modules  that  are  documented 
here.  The  first  caller,  in  alphabetical  order,  is  listed  as 
well.  The  specification  in  which  any  module  is  documented  may 
be  found  in  the  Module  Documentation  Index  (Document  Number 
CM  620100001).  See  section  3.10.6  for  a  list  of  the  modules 
that  call  each  of  these  external  routines. 


a«l  .*»  Vi 
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APPLICATION  INTERFACE  External  Routines  List 


Module  Name 


APACCT 

MEMCPY 

NSEND 

RCV 


First  User 


GETUIM 

GETUIM 

PUTLOC 

TERMVT 
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3.10.4  Include  File  List 

The  following  is  a  list  of  all  include  files  called  in 
by  modules  being  documented  here.  Each  include  file  has  a 
unique  name  regardless  of  the  language  being  used.  The  purpose 
of  each  include  file  is  listed  as  well.  A  more  complete 
description  of  each  include  file  is  given  in  section  3.10.9. 

The  purpose  listed  is  the  one  that  is  in  the  source  code  of  the 
i nc 1 ude  file. 

A  purpose  of  "***•  PURPOSE  NOT  FOUND  BY  STRIPPER  ****“ 
indicates  that  a  purpose  statement  was  not  written  into  the 
include  file  itself.  The  most  common  reason  for  this  is  that 
the  include  file  comes  from  system  libraries  that  were  not 
developed  by  the  project,  such  as  'C'  libraries  that  are 
provided  with  the  'C'  compiler. 

See  section  3.10.6  for  a  set  of  lists  which  show  all 
the  modules  which  call  in  each  of  these  include  files. 
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File  Name 


FPOODE 

NAPIEVB 

NAPINME 

NBUFAPI 

ROUTID 

SRVRET 

STDTYP 


APPLICATION  INTERFACE  Include  File  List 

Purpose 


Form  Processor  return  codes 
CORRECTED  C  VERSION  OF  APIEVB.INC 
CORRECTED  C  VERSION  OF  APINME.INC 
CORRECTED  C  VERSION  OF  BUFAPI.INC 
ROUTine  ID  definitions 
AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 
STANDARD  TYPE  DEFINITIONS 


I 

* 


1 


1 
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3.10.5  Where  Include  File  Used  List 

The  following  lists  each  include  file  from  3.10.4  and 
all  the  modules  documented  in  this  specification  which  include 
them.  The  purpose  of  each  module  is  listed  as  well. 
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APPLICATION  INTERFACE  Where- i nc 1 ude-f i le-used  List 

Inc?  Jde  Module  Module 

File  Name  Purpose 


FPOODE 

ADDELM  ADD  ELEMENT 

ADDFRM  ADD  FORM 

CHGLDV  CHANGE  LOGICAL  DEVICE 

CLSFRM  CLOSE  FORM 

CLSLDV  CLOSE  LOGICAL  DEVICE 

GDATA  GET  DATA 

GDATLN  GET  DATA  LENGTH 

GETATT  GET  ATTRIBUTES 

GETBAK  GET  BACKGROUND 

GETCUR  GET  CURSOR 

GPAGE  GET  PAGE 

GWINDO  GET  WINDOW 

INITVT  INITIAL  VTI 

INQLDV  INQUIRE  LOGICAL  DEVICE 

01 SCR  OUTPUT  /  INPUT  SCREEN 

OPNFRM  OPEN  FORM 

OPNLDV  OPEN  LOGICAL  DEVICE 

OUTSCR  OUTPUT  SCREEN 

PARFQN  PARSE  FULLY  QUALIFIED  NAME 

PDATA  PUT  DATA 

PMSGLC  PUT  MESSAGE  LINE  CODE 

PMSGLS  PUT  MESSAGE  LINE  STRING 

PUTATT  PUT  ATTRIBUTES 

PUTBAK  PUT  BACKGROUND 

PUTCUR  PUT  CURSOR 

PUTLOC  PUT  CURSOR  LOCATION 

RMVPAG  REMOVE  PAGE 

RPLFRM  REPLACE  FORM 

TERMVT  TERMINATE  VTI 


GET  USER  INTERFACE  MONITOR  AP 
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APPLICATION  INTERFACE  Where- include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


NAPINME 


NBUFAPI 


ROUTID 


GETOIM  GET  USER  INTERFACE  MONITOR  AP 


GETUIM 


ADDELM 

ADDFRM 

CHGLDV 

CLSFRM 

CLSLDV 

GDATA 

GDATLN 

GETATT 

GETBAK 

GETCUR 

GPAGE 

GWINDO 

INITVT 

INQLDV 

01  SCR 

OPNFRM 

OPNLDV 

OUTSCR 

PARFQN 

PDATA 

PMSGLC 

PMSGLS 

PUTATT 

PUTBAK 

PUTCUR 

PUTLOC 

RMVPAG 


GET  USER  INTERFACE  MONITOR  AP 


ADD  ELEMENT 
ADD  FORM 

CHANGE  LOGICAL  DEVICE 

CLOSE  FORM 

CLOSE  LOGICAL  DEVICE 

GET  DATA 

GET  DATA  LENGTH 

GET  ATTRIBUTES 

GET  BACKGROUND 

GET  CURSOR 

GET  PAGE 

GET  WINDOW 

INITIAL  VTI 

INQUIRE  LOGICAL  DEVICE 
OUTPUT  /  INPUT  SCREEN 
OPEN  FORM 

OPEN  LOGICAL  DEVICE 
OUTPUT  SCREEN 
PARSE  FULLY  QUALIFIED  NAME 
PUT  DATA 

PUT  MESSAGE  LINE  CODE 

PUT  MESSAGE  LINE  STRING 

PUT  ATTRIBUTES 

PUT  BACKGROUND 

PUT  CURSOR 

PUT  CURSOR  LOCATION 

REMOVE  PAGE 
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APPLICATION  INTERFACE  Where-include-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


RPLFRM  REPLACE  FORM 
TERMVT  TERMINATE  VTI 


SRVRET 

ADDELM  ADD  ELEMENT 

ADDFRM  ADD  FORM 

CHGLDV  CHANGE  LOGICAL  DEVICE 

CLSFRM  CLOSE  FORM 

CLSLDV  CLOSE  LOGICAL  DEVICE 

GDATA  GET  DATA 

GDATLN  GET  DATA  LENGTH 

GETATT  GET  ATTRIBUTES 

GETBAK  GET  BACKGROUND 

GETCUR  GET  CURSOR 

GPAG'C  GET  PAGE 

GWINDO  GET  WINDOW 

INITVT  INITIAL  VTI 

INQLDV  INQUIRE  LOGICAL  DEVICE 

01 SCR  OUTPUT  /  INPUT  SCREEN 

OPNFRM  OPEN  FORM 

OPNLDV  OPEN  LOGICAL  DEVICE 

OUTSCR  OUTPUT  SCREEN 

PARFQN  PARSE  FULLY  QUALIFIED  NAME 

PDATA  PUT  DATA 

PMSGLC  PUT  MESSAGE  LINE  CODE 

PMSGLS  PUT  MESSAGE  LINE  STRING 

PUT ATT  PUT  ATTRIBUTES 

PUTBAK  PUT  BACKGROUND 

PUTCUR  PUT  CURSOR 

PUTLOG  PUT  CURSOR  LOCATION 

RMVPAG  REMOVE  PAGE 

RPLFRM  REPLACE  FORM 

TERMVT  TERMINATE  VTI 
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APPLICATION  INTERFACE  Where- i nc lude-f i le-used  List 

Include  Module  Module 

File  Name  Purpose 


STDTYP 

GETOIM  GET  USER  INTERFACE  MONITOR  AP 


r 


N 

fc 

k 
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3.10.6  Where  External  Routine  Used  List 

The  following  lists  each  external  function  or  routine 
listed  in  3.10.3  and  all  the  documented  modules  which  call  it. 
The  purpose  of  each  module  is  listed  as  well. 
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APPLICATION  INTERFACE  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


APACCT 

GETUIM  GET  USER  INTERFACE  MONITOR  AP 


MEMCPY 

GETUIM  GET  USER  INTERFACE  MONITOR  AP 


NSEND 

AODELM  ADD  ELEMENT 

ADDFRM  ADD  FORM 

CHGLDV  CHANGE  LOGICAL  DEVICE 

CLSFRM  CLOSE  FORM 

CLSLDV  CLOSE  LOGICAL  DEVICE 

GDATA  GET  DATA 

GDATLN  GET  DATA  LENGTH 

GET ATT  GET  ATTRIBUTES 

GETBAK  GET  BACKGROUND 

GETCUR  GET  CURSOR 

GPAGE  GET  PAGE 

GWINDO  GET  WINDOW 

INITVT  INITIAL  VTI 

INQLDV  INQUIRE  LOGICAL  DEVICE 

01 SCR  OUTPUT  /  INPUT  SCREEN 

OPNFRM  OPEN  FORM 

OPNLDV  OPEN  LOGICAL  DEVICE 

OUTSCR  OUTPUT  SCREEN 

PARFQN  PARSE  FULLY  QUALIFIED  NAME 

PDATA  PUT  DATA 

PMSGLC  PUT  MESSAGE  LINE  CODE 

PMSGLS  PUT  MESSAGE  LINE  STRING 

PUT ATT  PUT  ATTRIBUTES 

PUTBAK  PUT  BACKGROUND 

PUTCUR  PUT  CURSOR 

PUTLOC  PUT  CURSOR  LOCATION 

RMVPAG  REMOVE  PAGE 

RPLFRM  REPLACE  FORM 

TERMVT  TERMINATE  VTI 
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APPLICATION  INTERFACE  Where-external -routine-used  List 

System  Module  Module 

Module  Name  Purpose 


RCV 

ADDELM  ADD  ELEMENT 

ADDFRM  ADD  FORM 

CHGLDV  CHANGE  LOGICAL  DEVICE 

CLSFRM  CLOSE  FORM 

CLSLDV  CLOSE  LOGICAL  DEVICE 

GDATA  GET  DATA 

GDATLN  GET  DATA  LENGTH 

GET ATT  GET  ATTRIBUTES 

GETBAK  GET  BACKGROUND 

GETCUR  GET  CURSOR 

GPAGE  GET  PAGE 

GWINDO  GET  WINDOW 

INITVT  INITIAL  VTI 

INQLDV  INQUIRE  LOGICAL  DEVICE 

OISCR  OUTPUT  /  INPUT  SCREEN 

OPNFRM  OPEN  FORM 

OPNLDV  OPEN  LOGICAL  DEVICE 

OUTSCR  OUTPUT  SCREEN 

PARFQN  PARSE  FULLY  QUALIFIED  NAME 

PDATA  PUT  DATA 

PUTATT  PUT  ATTRIBUTES 

PUTBAK  PUT  BACKGROUND 

PUTCUR  PUT  CURSOR 

PUTLOC  PUT  CURSOR  LOCATION 

RMVPAG  REMOVE  PAGE 

RPLFRM  REPLACE  FORM 

TERMVT  TERMINATE  VTI 
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3.10.7  Main  Program  Parts  List 

The  following  lists  each  Main  Program  listed  in  3.10.1 
and  all  the  module^  which  are  called  either  by  that  module 
itself  or  by  any  of  the  documented  modules  which  it  calls.  It 
is  possible  for  a  non-main  module  to  be  listed  more  that  once 
if  it  is  called  by  multiple  modules.  The  called  modules,  in 
this  case  known  as  program  parts,  are  marked  as  to  whether 
they  are  documented  here.  If  so,  the  phrase  “well-defined 
module"  appears  by  the  module  name,  if  not  it  is  an  “external 
"routine".  The  Purpose  of  the  Main  Program  module  is  listed 
as  well. 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

ADDELM 

Purpose — > ADD  ELEMENT 

APACCT 

External  routine 

GETUIM 

Well-defined  modul 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

ADDFRM 

Purpose-- > ADD  FORM 

APACCT 

External  routine 

GETOIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CHGLDV 

Purpose —  >  CHANGE  LOGICAL  DEVICE 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CLSFRM 

Purpose — > CLOSE  FORM 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

CLSLDV 

Purpose— > CLOSE  LOGICAL  DEVICE 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


GDATA 


APACCT 

GETUIM 

MEMCPY 

NSEND 

RCV 


Purpose — >  GET  DATA 

External  routine 
Veil-defined  module 
External  routine 
External  routine 
External  routine 


:■ 

f. 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GETATT 

Purpose— > GET  ATTRIBUTES 

APACCT 

External  routine 

GETUIM 

Well-defined  moduli 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


GETBAK 


APACCT 

GETUIM 

MEMCPY 

NSEND 

RCV 


Purpose— >GET  BACKGROUND 

External  routine 
Well-defined  module 
External  routine 
External  routine 
External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GETCUR 

Purpose — >GET  CURSOR 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 

Main  Pgm  Module  Module 

Name  Name  Type 


GPAGE  Purpose — >GET  PAGE 

APACCT  External  routine 

GETUIM  Well-defined  module 

MEMCPY  External  routine 

NSEND  External  routine 

RCV  External  routine 


1 


APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

GWINDO  Purpose— > GET  WINDOW 


APACCT 

External 

routine 

GETUIM 

Well-defined  module 

MEMCPY 

External 

routine 

NSEND 

External 

routine 

RCV 

External 

routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 
Name 


INITVT 


Module 

Name 


Module 

Type 


Purpose— » INITIAL  VTI 
APACCT  External  routine 

GETUIM  Well-defined  module 

MEMCPY  External  routine 

NSEND  External  routine 

RCV  External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

INQLDV 

Purpose —  > INQUIRE  LOGICAL  DEVICE 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

01  SCR 

Purpose— > OUTPUT  /  INPUT  SCREEN 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

OPNFRM 

Purpose— >  OPEN  FORM 

APACCT 

External  routine 

GETUIM 

Well-defined  modul 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

OPNLDV 

Purpose-- > OPEN  LOGICAL  DEVICE 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 

E 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

OUTSCR 

Purpose — > OUTPUT  SCREEN 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Paris  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PARFQN 

Purpose— >  PARSE  FULLY  QUALIFIED  NAME 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm  Module 
Name  Name 


PDATA 


APACCT 

GDATLN 

GETUIM 

MEMCPY 

NSEND 

RCV 


Module 

Type 


Purpose —  >  POT  DATA 

External  routine 
Well-defined  module 
Well-defined  module 
External  routine 
External  routine 
External  routine 


3-41 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PMSGLC 

APACCT 

GETUIM 

MEMCPY 

NSEND 

Purpose—  » PUT  MESSAGE  LINE  CODE 

External  routine 

Well-defined  nodule 

External  routine 

External  routine 

3-42 
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APPLICATION  INTERFACE  Main  Program  Paris  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PMSGLS 


APACCT 

GETUIM 

MEMCPY 

NSEND 


Purpose— > POT  MESSAGE  LINE  STRING 
External  routine 
Well-defined  module 
External  routine 
External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  <rg» 

Module 

Module 

Name 

Name 

Type 

PUTATT 

Purpose — >PUT  ATTRIBUTES 

APACCT 

External  routine 

GETOIM 

Well-defined  modul 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 

> 

5 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Nodule 

Module 

Name 

Name 

Type 

PUTBAK 

Purpose— >  PUT  BACKGROUND 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

HEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Paris  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PUTCUR 

Purpose — >  PUT  CURSOR 

APACCT 

External  routine 

GETUIM 

Well-defined  modul 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 

c 


.4,.- 


f  01  a. 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

PUTLOC 

Purpose— >  PUT  CURSOR  LOCATION 

APACCT 

External 

routine 

GETOIM 

Well-defined  module 

MEMCPY 

External 

routine 

HSEND 

External 

routine 

RCV 

External 

routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

RMVPAG 

Purpose — > REMOVE  PAGE 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Paris  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

RPLFRM 

Purpose-- > REPLACE  FORM 

APACCT 

External  routine 

GETUIM 

Well-defined  modul 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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APPLICATION  INTERFACE  Main  Program  Parts  List 


Main  Pgm 

Module 

Module 

Name 

Name 

Type 

TERMVT 

Purpose— > TERMINATE  VTI 

APACCT 

External  routine 

GETUIM 

Well-defined  module 

MEMCPY 

External  routine 

NSEND 

External  routine 

RCV 

External  routine 
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3.10.8  Module  Documentation 

The  following  documentation  describes  information 
which  is  specific  to  each  individual  module  being  documented 
in  this  specification  as  listed  in  section  3.10.2.  It 
provides  a  compact  way  of  getting  information  that  would  be 
otherwise  buried  within  each  module's  source  code. 

The  specific  items  in  this  module  documentation  have  the 
following  meanings: 

NAME:  Name  of  program  Module. 

PURPOSE:  Purpose  of  Module  as  detailed  in  the 

source  code . 

LANGUAGE:  Programming  language  source  code  is 

written  in. 

The  choices  are: 

VAX- 11  FORTRAN 

C  CI/S-1  Workbench  C) 

VAX- 11  COBOL 

MODULE  TYPE:  Whether  a  Program,  Subroutine,  or 

Function. 

Name  of  Source  File  from  file 
specification . 

Source  File  Extension  from  file 
specification . 

Whether  this  is  a  host -dependent 
routine  (VAX  or  IBM)  or  blank  if 
host- independent . 

IISS  sub-system  this  file  resides  in. 

Sub-directory  of  that  subsystem  in 
which  this  file  resides. 

DOCUMENTATION  GROUP:  Name  of  documentation  group  of  which 

this  source  file  is  a  member. 


SOURCE  FILE: 

SOURCE  FILE  TYPE: 

HOST: 

SUBSYSTEM : 
SUBDIRECTORY : 


DESCRIPTION: 


A  description  of  the  module  as  otained 
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i 


ARGUMENTS : 


INCLUDE  FILES: 


ROUTINES  CALLED: 


CALLED  DIRECTLY  BY: 


from  the  source  code. 

The  arguments  with  which  this  routine 
is  called  if  it  is  a  Subroutine  or  a 
Function . 

A  list  of  all  the  files  that  are 
included  into  this  module  as  well  as 
their  purposes. 

Subroutines  or  Functions,  either 
documented  or  external,  called  by 
this  module,  if  any. 

The  documented  routines  which  call 
this  module,  if  any. 


USED  IN  MAIN  PROGRAM(S) :  The  documented  Main  Programs  which 

contain  this  module  in  their  parts 
list  according  to  the  list  in  section 
3.10.7. 


The  Module  Documentation  is  arranged  alphabetically  according 
to  Module  Name. 
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APPLICATION  INTERFACE  Module  Documentation 


ADDELM 
ADD  ELEMENT 
VAX- 11  COBOL 
PROGRAM 
ADDELM 

DESCRIPTION: 


INCLUDE  FILES: 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


ADDFRM 
ADD  FORM 
VAX- 11  COBOL 
PROGRAM 
ADDFRM 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


CHGLDV 

CHANGE  LOGICAL  DEVICE 
VAX- 11  COBOL 
PROGRAM 
CHGLDV 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Fore  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


CLSFRM 
CLOSE  FORM 
VAX- 11  COBOL 
PROGRAM 
CLSFRM 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUT ID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


CLSLDV 

CLOSE  LOGICAL  DEVICE 
VAX- 11  COBOL 
PROGRAM 
CLSLDV 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE -FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


GDATA 
GET  DATA 
VAX- 11  COBOL 
PROGRAM 
GDATA 

DESCRIPTION: 


INCLUDE  FILES: 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NS  END 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


GDATLN 

GET  DATA  LENGTH 
VAX- 11  COBOL 
PROGRAM 
GDATLN 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 


CALLED  DIRECTLY  BY: 


PDATA  -  PUT  DATA 


USED  IN  MAIN  PROGRAM(S) : 


PDATA 


PUT  DATA 
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APPLICATION  INTERFACE  Module  Documentat ion 


GETATT 

GET  ATTRIBUTES 
VAX- 11  COBOL 
PROGRAM 
GETATT 

DESCRIPTION: 


INCLUDE  FILES: 


MAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NS  END 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 
PURPOSE: 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


GETBAJC 

GET  BACKGROUND 
VAX- 11  COBOL 
PROGRAM 
GETBAK 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED : 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 

DESCRIPTION: 


GETCUR 
GET  CURSOR 
VAX- 11  COBOL 
PROGRAM 
GETCUR 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documental ion 


NAME: 

PURPOSE : 

LANGUAGE: 

MODULE  TYPE: 
FUNCTION  TYPE: 
SOURCE  FILE: 
SOURCE  FILE  TYPE: 
HOST: 


GETUIM 

GET  USER  INTERFACE  MONITOR  AP 
C 

FUNCTION 
FORTRAN  VOID  () 

GETUIM 

.C 


SUBSYSTEM :  UI 

SUBDIRECTORY :  FPAI 

DOCUMENTATION  GROUP:  FPAI 


DESCRIPTION: 


SYNOPSIS 

FORTRAN  VOID  GETUIM( UIAPNM ,  UICHAN.  ROODE) 
CHAR  UIAPNM [APNAM_LEN] ,  UICHAN [LCHAN_LEN] , 
RCODE [ RCODE  LEN] ; 


OUTPUTS : 

UIAPNM  -  AP  NAME  OF  UIM 
UICHAN  -  LOGICAL  CHANNEL  FOR  UIM 
RCODE  -  RETURN  CODE 

DESCRIPTION 

RETURNS  THE  AP  NAME  AND  LOGICAL  CHANNEL  OF  THE  USER 

INTERFACE  MONITOR. 


ARGUMENTS : 


UIAPNM  - 
UICHAN  - 
RCODE  - 


CHAR  [ APNAM_LEN  ] 
CHAR  [ LCHAN_LEN  ] 
CHAR  [RCODE_LEN  ] 


INCLUDE  FILES: 


STDTYP  -  STANDARD  TYPE  DEFINITIONS 

HAPINME  -  CORRECTED  C  VERSION  OF  APINME.INC 

NBUFAPI  -  CORRECTED  C  VERSION  OF  BUFAPI . INC 

NAPIEVB  -  CORRECTED  C  VERSION  OF  APIEVB.INC 
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ROUTINES  CALLED: 


APACCT 

MEMCPY 


CALLED  DIRECTLY  BY: 


ADDELM 

ADD  ELEMENT 

ADDFRM 

- 

ADD  FORM 

CHGLDV 

- 

CHANGE  LOGICAL  DEVICE 

CLSFRM 

- 

CLOSE  FORM 

CLSLDV 

- 

CLOSE  LOGICAL  DEVICE 

GDATA 

- 

GET  DATA 

GDATLN 

- 

GET  DATA  LENGTH 

GETATT 

- 

GET  ATTRIBUTES 

GETBAK 

- 

GET  BACKGROUND 

GETCUR 

- 

GET  CURSOR 

GPAGE 

- 

GET  PAGE 

GWINDO 

- 

GET  WINDOW 

INITVT 

- 

INITIAL  VTI 

INQLDV 

- 

INQUIRE  LOGICAL  DEVICE 

01  SCR 

- 

OUTPUT  /  INPUT  SCREEN 

OPNFRM 

- 

OPEN  FORM 

OPNLDV 

- 

OPEN  LOGICAL  DEVICE 

OUTSCR 

- 

OUTPUT  SCREEN 

PARFQN 

- 

PARSE  FULLY  QUALIFIED  NAME 

PDATA 

- 

PUT  DATA 

PMSGLC 

- 

PUT  MESSAGE  LINE  CODE 

PMSGLS 

- 

PUT  MESSAGE  LINE  STRING 

PUTATT 

- 

PUT  ATTRIBUTES 

PUTBAK 

- 

PUT  BACKGROUND 

PUTCUR 

- 

PUT  CURSOR 

PUTLOC 

- 

PUT  CURSOR  LOCATION 

RMVPAG 

- 

REMOVE  PAGE 

RPLFRM 

— 

REPLACE  FORM 

TERMVT 

- 

TERMINATE  VTI 

USED  IN  MAIN  PROGRAM ( S ) : 


ADDELM  -  ADD  ELEMENT 

ADDFRM  -  ADD  FORM 

CHGLDV  -  CHANGE  LOGICAL  DEVICE 

CLSFRM  -  CLOSE  FORM 

CLSLDV  -  CLOSE  LOGICAL  DEVICE 


i 

I 


t 


GDATA 

- 

GET  DATA 

GETATT 

- 

GET  ATTRIBUTES 

GETBAK 

- 

GET  BACKGROUND 

GETCUR 

- 

GET  CURSOR 

GPAGE 

- 

GET  PAGE 

GWINDO 

- 

GET  WINDOW 

INITVT 

— 

INITIAL  VTI 

INQLDV 

- 

INQUIRE  LOGICAL  DEVICE 

01  SCR 

- 

OUTPUT  /  INPUT  SCREEN 

OPNFRM 

- 

OPEN  FORM 

OPNLDV 

— 

OPEN  LOGICAL  DEVICE 

OUTSCR 

— 

OUTPUT  SCREEN 

PARFQN 

- 

PARSE  FULLY  QUALIFIED  NAME 

PDATA 

- 

PUT  DATA 

PMSGLC 

- 

PUT  MESSAGE  LINE  CODE 

PMSGLS 

- 

PUT  MESSAGE  LINE  STRING 

POTATT 

- 

PUT  ATTRIBUTES 

PUTBAK 

- 

PUT  BACKGROUND 

PUTCUR 

- 

PUT  CURSOR 

POTLOC 

— 

PUT  CURSOR  LOCATION 

RMVPAG 

- 

REMOVE  PAGE 

RPLFRM 

- 

REPLACE  FORM 

TERMVT 

— 

TERMINATE  VTI 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 

DESCRIPTION: 


GPAGE 
GET  PAGE 
VAX- 11  COBOL 
PROGRAM 
GPAGE 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


GWINDO 
GET  WINDOW 
VAX- 11  COBOL 
PROGRAM 
GWINDO 


DESCRIPTION 


INCLUDE  FILES 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NS  END 

RCV 
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I 

I 

!  APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


INITFP 

INITialize  Fora  Processor 

VAX- 11  COBOL 

PROGRAM 

INITFP 
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DESCRIPTION: 
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APPLICATION  INTENT ACE  Module  Docuaen t at 1 on 


NAME: 
PURPOSE: 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  PILE: 


IMITVT 
INITIAL  VT1 
VAX- 11  COBOL 
PROGRAM 
IMITVT 


DESCRIPTION: 


INCLUDE  FILES: 


FPGODE  -  Fora  Processor  return  codes 

ROUT ID  -  ROUTlne  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NS  FIND 
RCV 


■-Tr.ir.Trui 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 
PURPOSE : 
LANGUAGE: 
NODULE  TYPE 
SOURCE  PILE 

DESCRIPTION 


INQLDV 

INQUIRE  LOGICAL  DEVICE 
VAX- 11  COBOL 
PROGRAM 
INQLDV 


INCLUDE  FILES: 

FPCODE  -  Fora  Processor  return  codes 

ROUT ID  -  ROUT i ne  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM 
NS  END 
RCV 


-  GET  USER  INTERFACE  MONITOR  AP 
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APPLICATION  INTERFACE  Module  Docueentat ion 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE : 
SOURCE  FILE: 


01  SCR 

OUTPUT  /  INPUT  SCREEN 
VAX- 11  COBOL 
PROGRAM 
01  SCR 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Fore  Processor  return  codes 

ROUT ID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


OPNLDV 

OPEN  LOGICAL  DEVICE 
VAX- 11  COBOL 
PROGRAM 
OPNLDV 

DESCRIPTION: 


INCLUDE  FILES: 


NAME: 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


FPOODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Docuaentat Ion 


OUTSCR 

OUTPUT  SCREEN 
VAX- 11  COBOL 
PROGRAM 
OUTSCR 

DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Fora  Processor  return  oodes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


GETUIM 

NSEND 

RCV 


GET  USER  INTERFACE  MONITOR  AP 
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APPLICATION  INTERFACE  Nodule  Documentation 


■AMK: 
PURP08E: 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  PILE: 


PARFQN 

PARSE  PULL!  QUALIFIED  RAMS 

VAX- 11  COBOL 

PROGRAM 

PARPQM 


DESCRIPTION: 


INCLUDE  FILES: 


FPOODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTlne  ID  definitions 

8RVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-PULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 
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APPLICATION  INTUIT ACE  Module  Documentation 


NANS: 

PURPOSE 
LANGUAGE: 
MODULE  TTPE 
•OUNCE  PILE: 


PDATA 
PUT  DATA 
VAX- 11  COBOL 
PROGRAM 
PDATA 


DESCRIPTION: 


INCLUDE  TILES: 


TPOODE  -  Pore  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

8RVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-PULL  ERROR 


ROUTINES  CALLED: 


GDATLM  -  GET  DATA  LENGTH 

GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEMD 
RCV 
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APPLICATION  INTERFACE  Module  Docueentat 1 on 


PMSGLC 

PUT  MESSAGE  LINE  CODE 
VAX- 11  COBOL 
PROGRAM 
PMSGLC 

DESCRIPTION: 


INCLUDE  FILES: 


NAME: 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


FPCODE  -  Fore  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


PMSGLS 

PUT  MESSAGE  LINE  STRING 

VAX- 11  COBOL 

PROGRAM 

PMSGLS 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 
NS  END 


iHMimmu 
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APPLICATION  INTERFACE  Nodule  Docuaentat ion 


NAME: 
PURPOSE: 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


PUTATT 

PUT  ATTRIBUTES 
VAX- 11  COBOL 
PROGRAM 
PUTATT 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Fora  Processor  return  codes 
ROUT ID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUTM 

NSEND 

RCV 


GET  USER  INTERFACE  MONITOR  AP 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE : 


PUTBAK 

PUT  BACKGROUND 
VAX- 11  COBOL 
PROGRAM 
PUTBAX 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Form  Trocessor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 


3-80 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 
PURPOSE: 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


PUTCUR 
PUT  CURSOR 
VAX- 11  COBOL 
PROGRAM 
PUTCUR 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE  -  Fora  Processor  return  codes 

ROUT ID  -  ROUTlne  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 


■»-  jn.  i 
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APPLICATION  INTERFACE;  Module  Documentation 


NAME  : 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 

DESCRIPTION: 


INCLUDE  FILES 


PUTLOC 

PUT  CURSOR  LOCATION 
VAX- 11  COBOL 
PROGRAM 
PUTLOC 


FPOODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE -FULL  ERROR 


ROUTINES  CALLED: 


GETUIM 

NSEND 

RCV 


-  GET  USER  INTERFACE  MONITOR  AP 


f*D-fll82  662 
UNCLASSIFIED 


INTEGRATED  INFORMATION  SUPPORT  SVSTEA  (IISS)  VOLUME  ( 
USER  INTERFACE  SUBS.  .  <U)  GENERAL  ELECTRIC  CO 
SCHENECTADV  NV  PRODUCTION  RESOURCES  CONSU.  . 

C  NORENC  ET  AL.  81  NOV  85  PS-628144788 


2/2 


F/O  12/S 


NL 


y 


MICROCOPY  RESOLUTION  TEST  CHART 

NATIONAL  BUREAU  OF  STANDARDS- 1%3-A 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 


RMVPAG 
REMOVE  PAGE 
VAX- 11  COBOL 
PROGRAM 
RMVPAG 


DESCRIPTION: 


INCLUDE  FILES: 


FPOODE  -  Form  Processor  return  codes 

ROUT ID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 
PURPOSE: 
LANGUAGE : 
MODULE  TYPE: 
SOURCE  FILE: 

DESCRIPTION: 


RPLFRM 
REPLACE  FORM 
VAX- 11  COBOL 
PROGRAM 
RPLFRM 


INCLUDE  FILES: 


FPCODE  -  Form  Processor  return  codes 

ROUTID  -  ROUTine  ID  definitions 

SRVRET  -  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 
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APPLICATION  INTERFACE  Nodule  Documentation 


NAME:  TERMFP 

PURPOSE:  EXIT  FORM  PROCESSOR 

LANGUAGE:  VAX- 11  COBOL 

MODULE  TYPE:  PROGRAM 

SOURCE  FILE :  TERMFP 

DESCRIPTION: 
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APPLICATION  INTERFACE  Module  Documentation 


NAME: 

PURPOSE : 
LANGUAGE: 
MODULE  TYPE: 
SOURCE  FILE: 


TERMVT 

TERMINATE  VTI 
VAX- 11  COBOL 
PROGRAM 
TERMVT 


DESCRIPTION: 


INCLUDE  FILES: 


FPCODE 

ROUTID 

SRVRET 


Form  Processor  return  codes 
ROUTine  ID  definitions 

AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 


ROUTINES  CALLED: 


GETUIM  -  GET  USER  INTERFACE  MONITOR  AP 

NSEND 

RCV 


PS  620144700 
1  November  1985 


3.10.9  Include  File  Descriptions 

The  following  list  contains  a  purpose  and  description  of 
each  include  file  listed  in  3.10.4  as  specified  in  the  source 
code.  The  language  it  is  written  in  is  also  given. 


APPLICATION  INTERFACE  Include  File  Description 


I 

f 

t 

t 

t 


FILE  NAME:  FPCODE 

PURPOSE:  Fori  Processor  return  codes 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


3-88 


L, 
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APPLICATION  INTERFACE  Include  File  Description 


FILE  NAME:  NAPIEVB 

PURPOSE:  CORRECTED  C  VERSION  OF  APIEVB.INC 

LANGUAGE:  C 

DESCRIPTION: 


3-89 
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APPLICATION  INTERFACE  Include  File  Description 


FILE  NAME:  MBUFAPI 

PURPOSE:  CORRECTED  C  VERSION  OF  BUFAPI . INC 

LANGUAGE:  C 


DESCRIPTION : 
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APPLICATION  INTERFACE  Include  File  Description 


FILE  NAME:  ROUT ID 

PURPOSE:  ROUTine  ID  definitions 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


DESCRIPTION:  THIS  INCLUDE  MEMBER  CONTAINS  THE  ROUTINE  ID 
DEFINITIONS  FOR  MESSAGING  BETWEEN  THE  FPAI 
AND  THE  FP. 

INFORMATION : 

TYPE:  (C -COBOL,  I C -COBOL  COPY)  IC 
SUBSYSTEM:  UI 
CONFIGURATION  ITEM  ID: 

DESIGNED  BY:  A.  J.  WEHRMAN 
START  DATE:  8/8/85 
FINISH  DATE:  8/8/85 

PROGRAMMED  BY:  A.  J.  WEHRMAN 
START  DATE:  8/8/85 
FINISH  DATE:  8/8/85 
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APPLICATION  INTERFACE  Include  File  Description 


FILE  NAME:  SRVRET 

PURPOSE:  AS  THE  RETURN  GIVEN  A  TABLE-FULL  ERROR 

LANGUAGE:  VAX- 11  COBOL 

DESCRIPTION: 


MODIFIED  11/2/83  TO  INCLUDE  RET -CODE -5 

MODIFIED  1/9/84  TO  INCREASE  ALL  ERROR  CODES  TO  PIC  X(5) 
AND  TO  ELIMINATE  ALPHA'S 

MODIFIED  1/26/84  TO  ADD  RET-CODE  FOR  GETUSR-NOT-SUCC 
SRV-SUCCESSFUL  ADDED  FOR  GENERIC  RETURN 
MODIFIED  2/7/84  TO  ADD  ERROR  CODES  FOR  ENTRY-NOT-FOUND 
MODIFIED  2/8/84  TO  ADD  WHTHST-NOT-SUCCESSFUL 
MODIFIED  2/20/84  TO  ADD  TSTMOD  NEW  CODES. 

MODIFIED  20  AUG  84  INITALIZE  ALL  LOCAL  VARAIBLES  TO 
SPACES  OR  0. 

MODIFIED  5/21/85  TO  ADD  RCL  AND  FILGEN  RETURN  CODES 


3-93 
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APPLICATION  INTERFACE  Include  File  Description 


FILE  NAME:  STDTYP 

PURPOSE:  STANDARD  TYPE  DEFINITIONS 

LANGUAGE :  C 

DESCRIPTION: 


DESCRIPTION 

THIS  FILE  ENSURES  THAT  THE  FOLLOWING  STANDARD  TYPES  ARE 

AVAILABLE: 

FLOAT  -  SINGLE  PRECISION  FLOAT 

DOUBLE  -  DOUBLE  PRECISION  FLOAT 

LONG  -  32  BIT  (OR  LARGER)  SIGNED  INTEGER 

LB ITS  -  32  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

INT  -  NATURAL  SIZE  SIGNED  INTEGER 

UNSIGNED  -  NATURAL  SIZE  UNSIGNED  INTEGER 

BOOL  -  NATURAL  SIZE  LOGICAL  (ZERO  /  NON-ZERO  ONLY) 

SHORT  -  16  BIT  (OR  LARGER)  SIGNED  INTEGER 

USHORT  -  16  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

BITS  -  16  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 

CHAR  -  SINGLE  MACHINE  CHARACTER  (REAL  CHARACTERS 
ALWAYS  POSITIVE) 

TINY  -  8  BIT  (OR  LARGER)  SIGNED  INTEGER 

UTINY  -  8  BIT  (OR  LARGER)  UNSIGNED  INTEGER 

TBITS  -  8  BITS  (OR  MORE)  FOR  BIT  MANIPULATION 
TBOOL  -  8  BIT  (OR  LARGER)  LOGICAL  (ZERO  /  NON-ZERO 
ONLY) 

METACHAR  -  16  BIT  (OR  LARGER)  AUGMENTED  CHARACTER 
(SIGNED) 

VOID  -  FUNCTION  THAT  RETURNS  NO  VALUE 

FORTRAN  -  STORAGE  CLASS  FOR  FOREIGN  (NON-C)  ROUTINES 
OR  C  ROUTINES 

WHICH  ARE  CALLABLE  FROM  FOREIGN  ROUTINES 

SINCE  NOT  ALL  COMPILERS  SUPPORT  USHORT,  TINY,  AND  UTINY, 

THE  FUNCTIONS 
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DSHORTO,  TINYO,  AND  UTINY( )  SHOULD  BE  USED  WHENEVER 

REFERENCING  THEM. 

IN  ADDITION.  THE  FOLLOWING  UTILITY  MACROS  ARE  DEFINED: 
LURSHIFT(N,  B)  -  UNSIGNED  LONG  RIGHT  SHIFT 
MAXCA.  B)  -  MAXIMUM  OF  A  AND  B 

MIN(A ,  B)  -  MINIMUM  OF  A  AND  B 
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APPLICATION  INTERFACE  Include  File  Description 


ABS(A)  -  ABSOLUTE  VALUE  OF  A 

STRASNCA.  B)  -  TRANSPORTABLE  A  -  B  FOR  STRUCTURES 

NULL  -  NULL  POINTER  VALUE  (0) 

TRUE  -  1 

FALSE  -  0 

SUCCESS  -  EXIT( SUCCESS)  INDICATES  SUCCESSFUL 

COMPLETION 

FAILURE  -  EXIT( FAILURE)  INDICATES  ERRORS 

THE  FOLLOWING  SYMBOLS  SHOULD  BE  DEFINED  BASED  ON  THE 

COMPILER  BEING  USED: 

USHORT  -  COMPILER  SUPPORTS  UNSIGNED  SHORT 
TINY  -  COMPILER  TREATS  CHAR  AS  SIGNED 
UTINY  -  CHAR  IS  SIGNED  AND  COMPILER  SUPPORTS 
UNSIGNED  CHAR 

VOID  -  COMPILER  SUPPORTS  VOID 
FORTRAN  -  COMPILER  SUPPORTS  FORTRAN 
STRASN  -  DEFINE  APPROPRIATE  MACRO 
SUCCESS  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  0 
FAILURE  -  DEFINE  APPROPRIATE  VALUE  IF  NOT  1 
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APPENDIX  A 

FP/AI  MESSAGE  FORMATS 

The  following  is  a  COBOL  declaration  of  the  message  formats 
used  between  the  AI  and  the  FP. 

FP  to  AI  message  formats,  FP  output  parameters. 

NOTE:  All  01  line  records  correspond  to  the  FP  routines  being 
called.  For  example,  ADDELM-FP -RECORD  is  used  in  the 
routine  ADDELM. 

01  ADDELM-FP -RECORD . 

05  ADDELM-ELEMENT-NUMBER  PIC  9(4). 

05  ADDELM -RCODE  PIC  X(5). 

01  ADDFRM-FP-RECORD  REDEFINES  ADDELM-FP -RECORD. 

05  ADDFRM - PAGE - NUMBER  PIC  9(4). 

05  ADDFRM -RCODE  PIC  X(5). 

01  CHGLDV-FP-RECORD  REDEFINES  ADDELM -FP -RECORD . 

05  CHGLDV -RCODE  PIC  X(5). 

01  CLSFRM-FP-RECORD  REDEFINES  ADDELM-FP-RECORD . 

05  CLSFRM-RCODE  PIC  X(5). 

01  CLSLDV-FP -RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  CLSLDV -RCODE  PIC  X(5). 

01  GDATA-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GDATA-BUFFER-LENGTH  PIC  9(4). 

05  GDATA-RGODE  PIC  X(5). 

05  GDATA-BUFFER  PIC  X(4096) . 

01  GDATLN-FP -RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GDATLN- BUFFER -LENGTH  PIC  9(4). 

05  GDATLN -RCODE  PIC  X(5). 

01  GETATT-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GETATT-ATTRIBUTE  PIC  X(10). 

05  GETATT-RCODE  PIC  X(5). 

01  GETBAK-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GETBAK- ATTRIBUTE  PIC  X(10). 

05  GETBAK-RCODE  PIC  X(5). 

01  GETCUR-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 


05 

GETCUR-FI ELD-NAME 

PIC  X( 120) . 

05 

GETCUR-FI ELD-TYPE 

PIC  X. 

05 

GETCUR-ROW 

PIC  9(4). 

05 

GETCUR-COL 

PIC  9(4). 

05 

GETCUR- RCODE 

PIC  X(5). 
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01  GPAGE-FP- RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GP AGE-FORM-NAME  PIC  X(10). 

05  GPAGE-RCODE  PIC  X(5). 

01  GWINDO-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  GWINDO-TOTAL-PAGES  PIC  9(4). 

05  GWINDO-RCODE  PIC  X(5). 

01  INQLDV-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  INQLDV-LOG-DEV-ID  PIC  9(5). 

05  INQLDV-RCODE  PIC  X(5). 

01  OISCR-FP-RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  OISCR-FUNCTION  PIC  9(4). 

05  01 SCR-RCODE  PIC  X(5). 

01  OPNFRM-FP -RECORD  REDEFINES  ADDELM-FP-RECORD. 

05  OPNFRM -RCODE  PIC  X(5). 

01  OPNLDV-FP -RECORD  REDEFINES  ADDELM-FP-RECORD. 


05 

OPNLDV-LOG-DEV-ID 

PIC  9(5). 

05 

OPNLDV-RCODE 

PIC  X(5) . 

01 

OUTSCR-FP-RECORD  REDEFINES 

ADDELM-FP-RECORD 

05 

OUTSCR-RCODE 

PIC  X(5) . 

01 

PARFQN-FP -RECORD  REDEFINES 

ADDELM-FP-RECORD 

05 

PARFQN - PAR-NAME 

PIC  X( 120) . 

05 

PARFQN-PAR-TYPE 

PIC  X. 

05 

PARFQN -RCODE 

PIC  X( 5 ) . 

01  PDATA-FP-REOORD  REDEFINES  ADDELM-FP-RECORD. 

05  PDATA-RCODE 
01  PUTATT-FP-RECORD 
05  PUTATT-RCODE 
01  PUTBAK-FP-RECORD 
05  PUTBAK-RCODE 
01  PUTCUR-FP-RECORD 
05  PUTCUR- RCODE 
01  PUTLOC-FP-RECORD 
05  POTLOC-RCODE 
01  RMVPAG-FP -RECORD 
05  RMVPAG-RCODE 
01  RPLFRM-FP -RECORD 
05  RPLFRM -RCODE 


AI  to  FP  message  format,  input  parameters. 


01  INPUT-RECORD. 

05  ROUTINE- ID  PIC  99. 

01  ADDELM-FPAI -RECORD  REDEFINES  INPUT-RECORD. 
05  ROUTINE-ID  PIC  99. 

05  ADDELM -ELEMENT-NAME  PIC  X( 120). 


REDEFINES 

REDEFINES 

REDEFINES 

REDEFINES 

REDEFINES 

REDEFINES 


PIC  X(5). 

ADDELM-FP- 
PIC  X( 5) . 

ADDELM-FP- 
PIC  X(5) . 

ADDELM-FP- 
PIC  X(5). 

ADDELM-FP- 
PIC  X(5) . 

ADDELM-FP- 
PIC  X( 5) . 

ADDELM-FP- 
PIC  X(5) . 


RECORD. 

RECORD. 

RECORD. 

RECORD. 

RECORD. 

RECORD. 


3-98 
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01  ADDFRM-FPAI -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE-ID 

PIC  99. 

05 

ADDFRM - W I NDOW -N AME 

PIC  X( 120) . 

05 

ADDFRM -FORM -NAME 

PIC  X(10). 

01 

CHGLDV-FPAI -RECORD  REDEFINES  INPUT-RECORD 

05 

ROUTINE- ID 

PIC  99. 

05 

CHGLDV -LOG-DEV- ID 

PIC  9(5). 

01 

CLSFRM-FPAI -RECORD  REDEFINES  INPUT-RECORD 

05 

ROUTINE- ID 

PIC  99. 

05 

CLSFRM-FORM-NAME 

PIC  X(10). 

01 

CLSLDV-FPAI -RECORD  REDEFINES  INPUT-RECORD 

05 

ROUTINE-ID 

PIC  99. 

OS 

CLSLDV -LOG-DEV - I D 

PIC  9(5). 

01 

GDATA-FPAI -RECORD  REDEFINES 

INPUT-RECORD . 

05 

ROUTINE- ID 

PIC  99. 

05 

GDATA- I N STANCE -ID 

PIC  9(4). 

05 

GDATA-FIELD-NAME 

PIC  X( 120) . 

01  GDATLN-FPAI -RECORD  REDEFINES  INPOT-RECORD. 
05  ROUTINE-ID  PIC  99. 

05  GDATLN-FI ELD- NAME  PIC  X(120). 


01  GETATT-FPAI -RECORD  REDEFINES  INPOT-RECORD. 


05 

ROUTINE-ID 

PIC  99. 

05 

GETATT-FIELD-NAME 

TIC  X( 120) . 

05 

GETATT-DURATION 

PIC  9(4). 

01  GETBAK-FPAI -RECORD  REDEFINES  INPOT-RECORD. 


05 

ROUTINE- ID 

PIC 

99. 

05 

GETBAK-F I ELD-NAME 

PIC 

X( 120) . 

05 

GETBAK-DURATION 

PIC 

9(4). 

01  GETCUR-FPAI -RECORD  REDEFINES  INPOT-RECORD. 

05  ROUTINE-ID  PIC  99. 

01  GPAGE-FPA I -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE- ID 

PIC  99. 

05 

GPAGE-WINDOW-NAME 

PIC  X( 120) . 

05 

GP AGE - PAGE -NUMBER 

PIC  9(4). 

01  GWINDO-FPAI -RECORD  REDEFINES  INPOT-RECORD. 
05  ROUTINE- ID  PIC  99. 

05  GW INDO -WINDOW-NAME  PIC  X(120). 

01  INQLDV-FPAI -RECORD  REDEFINES  INPOT-RECORD. 

05  ROUTINE- ID  PIC  99. 

01  01 SCR-FPAI -RECORD  REDEFINES  INPOT-RECORD. 

05  ROUTINE-ID  PIC  99. 

05  OISCR-WINDOW-NAME  PIC  X(120). 

01  OPNFRM-FPAI -RECORD  REDEFINES  INPOT-RECORD. 
05  ROUTINE- ID  PIC  99. 

05  OPNFRM-FORM-NAME  PIC  X(10). 

01  OPNLDV-FPA I -RECORD  REDEFINES  INPUT-RECORD. 
05  ROUTINE- ID  PIC  99. 
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01 

01 

01 

01 

01 

01 

01 

01 

01 

01 

01 


OUTSCR-FPAI -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE-ID 

PIC 

99. 

05 

OUTSCR-WINDOW-NAME 

PIC 

X( 120) . 

PARFQN-FPAI -RECORD  REDEFINES  INPUT-RECORD 

05 

ROUTINE-ID 

PIC 

99. 

05 

PARFQN -F I ELD-NAME 

PIC 

X( 120) . 

05 

PARFQN - F I ELD-TYPE 

PIC 

X. 

05 

P ARFQN - LEVEL 

PIC  9(4). 

PDATA-FPAI -RECORD  REDEFINES 

INPUT-RECORD. 

05 

ROUTINE-ID 

PIC 

99. 

05 

PDATA-F I ELD-NAME 

PIC 

o 

CJ 

H 

w 

X 

05 

PDATA-BUFFER 

PIC 

X(4096) . 

PMSGLC-FPAI -RECORD  REDEFINES  INPUT-RECORD. 
05  ROUTINE-ID  PIC  99. 

05  PMSGLC-MSG-CODE  PIC  X(5). 

PMSGLS-FPAI -RECORD  REDEFINES  INPUT-RECORD. 
05  ROUTINE-ID  PIC  99. 

05  PMSGLS -MSG- STRI NG  PIC  X(60). 

PUTATT-FPAI -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE-ID 

PIC 

99. 

05 

PUTATT-FIELD-NAME 

PIC 

X( 120) . 

05 

PUTATT-DURATION 

PIC  9(4). 

05 

PUT ATT -ATTRIBUTE 

PIC 

X( 10) . 

PUTBAK-FPAI -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE- ID 

PIC 

99. 

05 

PUTBAX -FIELD- NAME 

PIC 

X( 120) 

05 

PUTBAK-DURATION 

PIC 

9(4). 

05 

PUTBAX- ATTRI BUTE 

PIC 

X(10). 

PUTCUR-FPAI -RECORD  REDEFINES  INPUT-RECORD. 
05  ROUTINE- ID  PIC  99. 

05  PUTCUR-F I ELD-NAME  PIC  X(120). 

PUTLOC-FPAI -RECORD  REDEFINES  INPUT-RECORD. 


05 

ROUTINE- ID 

PIC 

99. 

05 

PUTLOC - F I ELD- N AME 

PIC 

X( 120) . 

05 

PUTLOC-ROW 

PIC 

9(4). 

05 

PUTLOC -COL 

PIC 

9(4). 

RMVPAG-FPAI -RECORD  REDEFINES  INPUT-RECORD 

05 

ROUTINE-ID 

PIC 

99. 

05 

RMVPAG-WINDOW-NAME 

PIC 

X( 120) . 

05 
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3.10.10  Hierarchy  Chart 

The  following  hierarchy  charts  show  the  relationships 
between  all  of  the  nodules  mentioned  in  the  above  documentat i on . 
A  nodule  nay  call  a  subroutine  several  tines  within  its  code, 
but  the  call  will  only  be  shown  once  as  a  single  relationship  on 
this  hierarchy  chart.  All  nodules  shown  at  the  top  of  the  first 
page  are  considered  Main  Programs  as  described  in  section  3.10.1 
above. 

There  is  am  internal  paging  scheme  as  narked  by  the  numbers 
in  the  upper  right  corner  of  each  page.  An  index  after  the  last 
page  of  the  chart  shows  where  a  routine  and  its  calls  are  first 
defined.  If  a  routine  has  no  page  reference,  it  either  nakes  no 
calls  or  is  an  external  routine.  A  continuation  box  on  the  end 
of  a  tree  limb  shows  where  that  the  tree  continues  on  the  page 
numbered  mentioned.  A  number  in  a  box  with  a  routine  name 
points  to  the  page  where  the  routine  is  further  defined  within 
the  hierarchy  tree.  If  there  is  no  number  in  a  box,  the  routine 
either  makes  no  calls  or  is  an  external  routine. 
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ADDELM .... 2 
ADDFRM ....  3 
APACCT 
CHGLDV . . . .4 
CLSFRM ....  5 
CLSLDV ....  1 

GDATA . 7 

GDATLN. . .20 
GET ATT. . . .8 
GETBAK. . . .9 
GETCUR. . . .6 
GETUIM. . . .2 
GPAGE ....  1 1 
GWINDO. . .12 
INITVT. . .13 
INQLOV. . .10 
MEMCPY 
NSEND 

01 SCR . . . .15 
OPNFRM. . .16 
OPNLDV . . .17 
OUTSCR ...  14 
PARFQN ...  19 
PDATA. . . .20 
PMSGLC. . .21 
PMSGLS. . .18 
PUTATT ...  23 
PUTBAK. . .24 
POTCUR ...  25 
PUTLOC. . .22 
RCV 

RMVPAG ...  27 
RPLFRM ... 26 
TERMVT ...  26 


PS  620144700 
1  November  1985 


3.11  Program  Listings  Comments 

This  information  is  contained  in  the  Module  Descriptions  in 
section  3.10. 
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SECTION  4 

QUALITY  ASSURANCE  PROVISIONS 


4 . 1  Introduction  and  Definitions 

"Testing”  is  a  systematic  process  that  may  be  preplanned 
and  explicitly  stated.  Test  techniques  and  procedures  may  be 
defined  in  advance,  and  a  sequence  of  test  steps  may  be 
specified.  "Debugging"  is  the  process  of  isolation  and 
correction  of  the  cause  of  an  error. 

"Antibugging"  is  defined  as  the  philosophy  of  writing 
programs  in  such  a  way  as  to  make  bugs  less  likely  to  occur  and 
when  they  do  occur,  to  make  them  more  noticeable  to  the 
programmer  and  the  user.  In  other  words,  as  much  error  checking 
as  is  practical  and  possible  in  each  routine  should  be 
performed . 

4.2  Computer  Programming  Test  and  Evaluation 

The  quality  assurance  provisions  for  test  consists  of  the 
normal  testing  techniques  that  are  accomplished  during  the 
construction  process.  They  consist  of  design  and  code 
walk-throughs,  unit  testing,  and  integration  tecting.  These 
tests  are  performed  by  the  design  team.  Structured  design, 
design  walk-through  and  the  incorporation  of  "antibugging" 
facilitate  this  testing  by  exposing  and  addressing  problem  areas 
before  they  become  coded  "bugs." 
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